package com.smart.community.region.service;

import com.smart.community.region.dto.BatchGenerateFeeRecordDTO;
import com.smart.community.region.dto.ShopFeeRecordDTO;
import com.smart.community.region.vo.ShopFeeRecordVO;

import java.util.List;
import java.util.Map;

/**
 * 店铺费用记录Service接口
 * 遵循《Java后端SpringBoot代码开发规范_重构版.md》Service层规范
 * 遵循《系统状态枚举权威标准声明.md》状态枚举规范
 * 
 * @author Wu.Liang
 * @version 1.0.0
 * @since 2025-01-30
 */
public interface IShopFeeRecordService {
    
    /**
     * 分页查询费用记录
     * 遵循《Java后端SpringBoot代码开发规范_重构版.md》Service层规范
     * 遵循《系统状态枚举权威标准声明.md》状态枚举规范
     * 
     * @param current 当前页
     * @param size 每页大小
     * @param shopId 店铺ID
     * @param feeType 费用类型
     * @param paymentStatus 支付状态
     * @param feeDateStart 费用日期开始
     * @param feeDateEnd 费用日期结束
     * @param dueDateStart 到期日期开始
     * @param dueDateEnd 到期日期结束
     * @return 分页结果
     * @throws Exception 异常
     */
    Object getFeeRecordPage(Integer current, Integer size, Long shopId, String feeType, Integer paymentStatus,
            String feeDateStart, String feeDateEnd, String dueDateStart, String dueDateEnd) throws Exception;
    
    /**
     * 根据ID获取费用记录详情
     * 遵循《Java后端SpringBoot代码开发规范_重构版.md》Service层规范
     * 
     * @param id 费用记录ID
     * @return 费用记录详情
     * @throws Exception 异常
     */
    ShopFeeRecordVO getFeeRecordDetail(Long id) throws Exception;
    
    /**
     * 创建费用记录
     * 遵循《Java后端SpringBoot代码开发规范_重构版.md》Service层规范
     * 
     * @param dto 费用记录DTO
     * @return 费用记录ID
     * @throws Exception 异常
     */
    Long createFeeRecord(ShopFeeRecordDTO dto) throws Exception;
    
    /**
     * 批量生成费用记录
     * 遵循《Java后端SpringBoot代码开发规范_重构版.md》Service层规范
     * 
     * @param dto 批量生成DTO
     * @return 生成结果
     * @throws Exception 异常
     */
    Object batchGenerateFeeRecords(BatchGenerateFeeRecordDTO dto) throws Exception;
    
    /**
     * 更新费用记录
     * 遵循《Java后端SpringBoot代码开发规范_重构版.md》Service层规范
     * 
     * @param id 费用记录ID
     * @param dto 费用记录DTO
     * @return 更新结果
     * @throws Exception 异常
     */
    Boolean updateFeeRecord(Long id, ShopFeeRecordDTO dto) throws Exception;
    
    /**
     * 删除费用记录
     * 遵循《Java后端SpringBoot代码开发规范_重构版.md》Service层规范
     * 
     * @param id 费用记录ID
     * @return 删除结果
     * @throws Exception 异常
     */
    Boolean deleteFeeRecord(Long id) throws Exception;
    
    /**
     * 批量删除费用记录
     * 遵循《Java后端SpringBoot代码开发规范_重构版.md》Service层规范
     * 
     * @param ids 费用记录ID列表
     * @return 删除结果
     * @throws Exception 异常
     */
    Boolean batchDeleteFeeRecords(List<Long> ids) throws Exception;
    
    /**
     * 获取费用统计信息
     * 遵循《Java后端SpringBoot代码开发规范_重构版.md》Service层规范
     * 
     * @param shopId 店铺ID
     * @param feeType 费用类型
     * @param paymentStatus 支付状态
     * @return 统计信息
     * @throws Exception 异常
     */
    Object getFeeStatistics(Long shopId, String feeType, Integer paymentStatus) throws Exception;
    
    /**
     * 支付费用记录
     * 遵循《Java后端SpringBoot代码开发规范_重构版.md》Service层规范
     * 
     * @param id 费用记录ID
     * @param paymentInfo 支付信息
     * @return 支付结果
     * @throws Exception 异常
     */
    Boolean payFeeRecord(Long id, Map<String, Object> paymentInfo) throws Exception;
    
    /**
     * 批量支付费用记录
     * 遵循《Java后端SpringBoot代码开发规范_重构版.md》Service层规范
     * 
     * @param ids 费用记录ID列表
     * @param paymentInfo 支付信息
     * @return 支付结果
     * @throws Exception 异常
     */
    Boolean batchPayFeeRecords(List<Long> ids, Map<String, Object> paymentInfo) throws Exception;
    
    /**
     * 催缴费用记录
     * 遵循《Java后端SpringBoot代码开发规范_重构版.md》Service层规范
     * 
     * @param id 费用记录ID
     * @return 催缴结果
     * @throws Exception 异常
     */
    Boolean remindFeeRecord(Long id) throws Exception;
    
    /**
     * 批量催缴费用记录
     * 遵循《Java后端SpringBoot代码开发规范_重构版.md》Service层规范
     * 
     * @param ids 费用记录ID列表
     * @return 催缴结果
     * @throws Exception 异常
     */
    Boolean batchRemindFeeRecords(List<Long> ids) throws Exception;
    
    /**
     * 导出费用记录
     * 遵循《Java后端SpringBoot代码开发规范_重构版.md》Service层规范
     * 
     * @param shopId 店铺ID
     * @param feeType 费用类型
     * @param paymentStatus 支付状态
     * @return 导出结果
     * @throws Exception 异常
     */
    String exportFeeRecords(Long shopId, String feeType, Integer paymentStatus) throws Exception;
}